home *** CD-ROM | disk | FTP | other *** search
/ Packard Bell - Internet on a CD / internet on a cd.cdr / Internet / sites / Clementine_NASA / softinfo.txt < prev    next >
Encoding:
Text File  |  1998-07-16  |  16.3 KB  |  212 lines
  1. PDS_VERSION_ID       = PDS3                                                   
  2. RECORD_TYPE          = FIXED_LENGTH                                           
  3. RECORD_BYTES         = 80                                                     
  4. OBJECT               = TEXT                                                   
  5.   INTERCHANGE_FORMAT = ASCII                                                  
  6.   PUBLICATION_DATE   = 1994-10-01                                             
  7.   NOTE               = "Description of software directory provided with the   
  8.                         Clementine CD-ROM set"                                
  9. END_OBJECT                                                                    
  10. END                                                                           
  11.                                                                               
  12.                                                                               
  13.                          Clementine  Software                                 
  14.                                                                               
  15. This directory contains software that provides display and processing         
  16. capabilities for the Clementine data archived on this CD-ROM set.             
  17.                                                                               
  18. 1.  Decompression Software                                                    
  19.                                                                               
  20.      The PCDOS, MAC and SUNOS subdirectories all contain software which can   
  21. be used to decompress the Clementine raw images.  CLEMDCMP will decompress    
  22. the raw image and output it into one of four formats:                         
  23.                                                                               
  24.      1) decompressed PDS labeled file which contains PDS labels, the          
  25.         histogram object, and an image object, either the browse image        
  26.         or the full image                                                     
  27.      2) decompressed image file, no labels                                    
  28.      3) a decompressed image in the GIF format                                
  29.      4) a decompressed image in the TIFF format                               
  30.                                                                               
  31.      The source code is provided in the SOURCE subdirectory, of each          
  32. platform subdirectory.  Instructions on how to install and run the            
  33. software is in the file CLEMDCMP.TXT in the DOC subdirectory, of each         
  34. platform subdirectory.                                                        
  35.                                                                               
  36.     Because the image decompression program, CLEMDCMP,  requires a Discrete   
  37. Cosine Transform (DCT) it may take several minutes to decompress an image on  
  38. hardware platforms with slow processors.  For example, in tests on a Macintosh
  39. IIci, the decompression takes approximately 4 minutes. CLEMDCMP has been      
  40. tested on hardware platforms with modern processors, such as an Intel         
  41. 486DX2/66-Mhz, and the decompression takes just several seconds.              
  42.                                                                               
  43.                                                                               
  44. 2. Display Software                                                           
  45.                                                                               
  46.      CLIMDISP in the PCDOS/BIN subdirectory is an image display and           
  47. processing program.  It can be used to display Clementine uncompressed        
  48. images and histograms.  See CLIMDISP.TXT in the PCDOS/DOC subdirectory        
  49. for instructions on how to install and run the program.                       
  50.                                                                               
  51.      Note: CLIMDISP currently can not create GIF formatted files for          
  52. the Clementine images.  Additionally, it can not read the version             
  53. of GIF files created by the Clementine Decompression (CLEMDCMP)               
  54. program which is also included on the Clementine EDR Archive                  
  55. CD-ROMs. If you wish to display Clementine images with CLIMDISP,              
  56. generate a PDS format image file when decompressing with CLEMDCMP.            
  57.                                                                               
  58.      A special version of NIH Image, found in the MAC/BIN subdirectory, will  
  59. display PDS decompressed Clementine images. This program is stored in a       
  60. Stuffit file which is in BinHex format. See IMAGE.TXT in the DOC subdirectory 
  61. for instructions on how to install and run the program.                       
  62.                                                                               
  63.      The Clementine EDR image files use the PDS label constructs              
  64. RECORD_TYPE = "UNK", and ^IMAGE = xxxxx <BYTES> to define the structure       
  65. of the file. This form of the labels is not supported by the current          
  66. versions of IMDISP and  IMAGE4PDS that are widely distributed by the PDS.     
  67. To read Clementine decompressed formatted files use the version of IMAGE      
  68. and CLIMDISP programs that are supplied on this CD-ROM. The Clementine        
  69. versions CLIMDISP and IMAGE have been tested only on the Clementine data      
  70. products. No attempt has been made to determine if the Clementine program     
  71. versions will work on any other PDS data product.                             
  72.                                                                               
  73.      XV is a shareware program for displaying images.  XV was written         
  74. by John Bradley of the University of Pennsylvania.  It is in a compressed     
  75. tar file in the SUNOS/SOURCE subdirectory.  See XV.TXT in the SUNOS/DOC       
  76. subdirectory for instructions on how to decompress and untar this file.       
  77. XV will not display PDS labeled files, but will display TIF and GIF           
  78. formatted files.                                                              
  79.                                                                               
  80.      The XV software, for image display on a sun/unix environment, is not     
  81. able to read the Clementine PDS labeled files. If you intend to use XV as     
  82. the display system for the CLementine data products, output GIF or TIFF       
  83. images with the CLEMDCMP program.                                             
  84.                                                                               
  85. 3. SPICE Software                                                             
  86.                                                                               
  87.      Included on one of the ancillary disks associated with this volume set   
  88. is the Navigation and Ancillary Information Facility (NAIF) Toolkit and       
  89. some additional NAIF software. The major component of the NAIF Toolkit        
  90. is the SPICE Library (SPICELIB), a collection of portable ANSI FORTRAN        
  91. 77 subroutines. Some of these subroutines are used to read the SPICE          
  92. kernel files containing Clementine ancillary data, such as spacecraft         
  93. position, spacecraft attitude, instrument orientation and target body         
  94. size, shape and orientation. Other SPICELIB subroutines may be used to        
  95. compute typical observation geometry parameters--such as range, lighting      
  96. angles, and LAT/LON of camera optic axis intercept on the target body.        
  97. Several utility programs and SPICELIB demonstration programs are also         
  98. included in the Toolkit. Versions of this software tested on many             
  99. popular platforms are provided, as are instructions for porting the code to   
  100. additional platforms. The FORTRAN subroutines can be called from a            
  101. user's own application program, whether written in FORTRAN or C, or           
  102. possibly yet another language. Consult your compiler's Reference Manual       
  103. for instructions.                                                             
  104.      One of the NAIF programs included in this software collection is         
  105. PICGEO (for Picture Geometry).  It was used to compute all of the             
  106. geometric parameters appearing in the image labels and index tables.  It      
  107. is included so that users may clearly see the algorithms used in computing    
  108. these quantities, and so that recalculation of image label geometry           
  109. parameters using revised algorithms, or adding additional parameters, can     
  110. be easily achieved.                                                           
  111.                                                                               
  112.                                                                               
  113. 4.  Miscellaneous Image Processing Software                                   
  114.                                                                               
  115.      MSHELL is an interactive command line and menu driven Image and Signal   
  116. processing language, developed by ACT Corp., which runs under the Microsoft   
  117. Windows 3.x or Microsoft NT.  MSHELL provides powerful scientific image and   
  118. signal visualization and processing.  A number of custom features were added  
  119. to the MSHELL Image/Signal Processing Environment to support the Clementine   
  120. Program. This software is included on one of the ancillary disks associated   
  121. with this volume set, and will be under a subdirectory of the PCDOS directory.
  122.                                                                               
  123.                                                                               
  124. 5.  Software Directory Hierarchy                                              
  125.                                                                               
  126.      The SOFTWARE subdirectories are based on hardware platforms.  Under      
  127. each platform subdirectory, the executables are in the BIN subdirectory,      
  128. the source is in the SOURCE subdirectory and documentation on each program    
  129. is in the DOC subdirectory.  Each DOC subdirectory contains a file,           
  130. SOFTWARE.CAT which is part of the PDS Software Inventory describing software  
  131. available within the Planetary Science Community. The contents of the SOFTWARE
  132. directory are shown below.                                                    
  133.                                                                               
  134.                                                                               
  135. [SOFTWARE]                                                                    
  136. |                                                                             
  137. |-SOFTINFO.TXT                                                                
  138. |                                                                             
  139. |                                                                             
  140. |                                                                             
  141. |                                                                             
  142. |-[PCDOS]                                                                     
  143. |  |                                                                          
  144. |  |-[BIN]                                                                    
  145. |  |   |                                                                      
  146. |  |   |-CLEMDCMP.EXE                                                         
  147. |  |   |                                                                      
  148. |  |   |-CLIMDISP.EXE                                                         
  149. |  |   |                                                                      
  150. |  |   |-CLIMDISP.HLP                                                         
  151. |  |                                                                          
  152. |  |-[SOURCE]                                                                 
  153. |  |   |                                                                      
  154. |  |   |-CLEMDCMP.C                                                           
  155. |  |   |-PDS.C                                                                
  156. |  |   |-BITSTRM.C                                                            
  157. |  |   |-DECOMP.C                                                             
  158. |  |   |-HUFFMAN.C                                                            
  159. |  |   |-WRITEGIF.C                                                           
  160. |  |   |-PDS.H                                                                
  161. |  |   |-JPEG_C.H                                                             
  162. |  |   |                                                                      
  163. |  |   |-CLEMDCMP.MAK                                                         
  164. |  |                                                                          
  165. |  |-[DOC]                                                                    
  166. |      |                                                                      
  167. |      |-CLEMDCMP.TXT                                                         
  168. |      |                                                                      
  169. |      |-CLIMDISP.TXT                                                         
  170. |      |                                                                      
  171. |      |-SOFTWARE.CAT                                                         
  172. |                                                                             
  173. |-[MAC]                                                                       
  174. |  |                                                                          
  175. |  |-[BIN]                                                                    
  176. |  |  |                                                                       
  177. |  |  |-CLEMDEXE.HQX                                                          
  178. |  |  |                                                                       
  179. |  |  |-IMAGE.HQX                                                             
  180. |  |                                                                          
  181. |  |-[SOURCE]                                                                 
  182. |  |  |                                                                       
  183. |  |  |-CLEMDSRC.HQX                                                          
  184. |  |                                                                          
  185. |  |-[DOC]                                                                    
  186. |     |                                                                       
  187. |     |-CLEMDCMP.TXT                                                          
  188. |     |                                                                       
  189. |     |-IMAGE.TXT                                                             
  190. |     |                                                                       
  191. |     |-SOFTWARE.CAT                                                          
  192. |                                                                             
  193. |-[SUNOS]                                                                     
  194.    |                                                                          
  195.    |-[BIN]                                                                    
  196.    |  |                                                                       
  197.    |  |-CLEMDEXE.TZU                                                          
  198.    |                                                                          
  199.    |-[SOURCE]                                                                 
  200.    |  |                                                                       
  201.    |  |-CLEMDSRC.TZU                                                          
  202.    |  |                                                                       
  203.    |  |-XV3A.TZ                                                               
  204.    |                                                                          
  205.    |-[DOC]                                                                    
  206.       |                                                                       
  207.       |-CLEMDCMP.TXT                                                          
  208.       |                                                                       
  209.       |-XV.TXT                                                                
  210.       |                                                                       
  211.       |-SOFTWARE.CAT                                                          
  212.